/*=========================================================================================================

                        EDIT HISTORY FOR MODULE

  This section contains comments describing changes made to the module.
  Notice that changes are listed in reverse chronological order.


when         who        what, where, why
--------   ------     ----------------------------------------------------------
08/31/2018   zhoujin    Created module

=========================================================================================================*/

#include "stm32f10x.h"                  // Device header
#include <string.h>
#include <stdio.h>
#include <stdarg.h>

uint8_t Serial_RxData;
uint8_t Serial_RxFlag = 0;

/************************************************************************************************************
* Function name : 初始化 USART1 
* Description   : 只使用 USART1 向外发送的功能
* Parameter     : 
* Return        : 
************************************************************************************************************/
void Serial_Init(void)
{
	//1.开启 USART + GPIOA的时钟
	RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE);
	RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);
	
	//2.GPIO初始化, 把TX配置成复用输出, Rx 配置成浮空 或 上拉输入均可
	GPIO_InitTypeDef GPIO_InitStructure;
	GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;                                  // TX 要设置成复用推挽输出          
	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9;
	GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
	GPIO_Init(GPIOA, &GPIO_InitStructure);
	
	GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU;                                    // RX 设置成浮空 或 上拉输入均可          
	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10;
	GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
	GPIO_Init(GPIOA, &GPIO_InitStructure); 
	
	//3.直接使用一个结构体, 配置USART1
	USART_InitTypeDef USART_InitStructure;
	USART_InitStructure.USART_BaudRate = 9600;                                       // 直接写波特率, USART_Init 会自动计算分频系数写入 BRR 寄存器
	USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None;  // 不使用流控 
	USART_InitStructure.USART_Mode = USART_Mode_Tx | USART_Mode_Rx;                  // 同时开启发送和接收
	USART_InitStructure.USART_Parity = USART_Parity_No;                              // 不需要校验
	USART_InitStructure.USART_StopBits = USART_StopBits_1;                           // 1 位停止位
	USART_InitStructure.USART_WordLength = USART_WordLength_8b;                      // 8 位数据位
	USART_Init(USART1, &USART_InitStructure);
	
	// 4. 开启 RXNE 标志位到 NVIC 的输出
	USART_ITConfig(USART1, USART_IT_RXNE, ENABLE);
	
	// 5. 配置 NVIC
	NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);                                  // 设置优先级分组为2
	NVIC_InitTypeDef NVIC_InitStructure;
	NVIC_InitStructure.NVIC_IRQChannel = USART1_IRQn;                                // 选择 USART1_IRQn 通道
	NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;                                  // 使能
	NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1;                        // 抢断优先级给 1
	NVIC_InitStructure.NVIC_IRQChannelSubPriority = 1;                               // 响应优先级给 1
	NVIC_Init(&NVIC_InitStructure);
	
	USART_Cmd(USART1, ENABLE);
}


/************************************************************************************************************
* Function name : Serial_SendByte
* Description   : 只使用 USART1 向外发送的功能
* Parameter     : Byte
* Return        : 
************************************************************************************************************/
void Serial_SendByte(uint8_t Byte)
{
	USART_SendData(USART1, Byte);
	while(USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET);                     // 一直等数据被搬运到发送移位寄存器
}


/************************************************************************************************************
* Function name : Serial_SendArray
* Description   : 通过 USART1 发送数组 Array
* Parameter     : Array   --- 数组
                  Length  --- 数组长度
* Return        : 
************************************************************************************************************/
void Serial_SendArray(const uint8_t *Array, uint16_t Length)
{
	for(uint16_t i = 0; i < Length; ++i)
	{
		Serial_SendByte(Array[i]);
	}
}


/************************************************************************************************************
* Function name : Serial_SendArray
* Description   : 通过 USART1 发送数组 Array
* Parameter     : Array   --- 数组
                  Length  --- 数组长度
* Return        : 
************************************************************************************************************/
void Serial_SendString(const char *str)
{
	uint16_t len = strlen(str);
	for(uint16_t i = 0; i < len; ++i)
	{
		Serial_SendByte(str[i]);
	}
}

static uint32_t Serial_Pow(uint32_t X, uint32_t Y)
{
	uint32_t Result = 1;
	while(Y--)
	{
		Result *= X;
	}
	return Result;
}

/************************************************************************************************************
* Function name : Serial_SendNumber
* Description   : 通过 USART1 以字符的方式发送 Number 的每一位
* Parameter     : Number  --- 数字
                  Length  --- 数字位数
* Return        : 
************************************************************************************************************/
void Serial_SendNumber(uint32_t Number, uint8_t Length)
{
	uint8_t i;
	for(i = 0; i < Length; ++i)
	{
		Serial_SendByte(Number / Serial_Pow(10, Length - i - 1) % 10 + '0');
	}
}


/************************************************************************************************************
* Function name : Serial_Printf
* Description   : 格式化输出字符串到指定的串口
* Parameter     : format  --- 格式化字符串
                  ...     --- 可变参数
* Return        : 
************************************************************************************************************/
void Serial_Printf(const char *format, ...)
{
	char str[1024] = {0};
	va_list arg;
	va_start(arg, format);
	vsprintf(str, format, arg);
	va_end(arg);
	Serial_SendString(str);
}


/************************************************************************************************************
* Function name : USART1_IRQHandler
* Description   : 接收数据的回调
* Parameter     : format  --- 格式化字符串
                  ...     --- 可变参数
* Return        : 
************************************************************************************************************/
void USART1_IRQHandler(void)
{
	// 判断中断标志位
	if(USART_GetFlagStatus(USART1, USART_IT_RXNE) == SET)
	{
		// 读取
		Serial_RxData = USART_ReceiveData(USART1);
		Serial_RxFlag = 1;
		
		// 虽然读取DR 会自动清除, 但是手动清除一下也无伤大雅
		USART_ClearITPendingBit(USART1, USART_IT_RXNE);
	}
}


/************************************************************************************************************
* Function name : Serial_GetRxData
* Description   : 获得串口接收到的数据
* Parameter     : 
* Return        : 
************************************************************************************************************/

int8_t Serial_GetRxData(void)
{
	return Serial_RxData;
}


/************************************************************************************************************
* Function name : Serial_GetRxFlag
* Description   : 若串口接收到了数据, 则此标志为 1
* Parameter     : format  --- 格式化字符串
                  ...     --- 可变参数
* Return        : 
************************************************************************************************************/
uint8_t Serial_GetRxFlag(void)
{
	if(Serial_RxFlag == 1)
	{
		Serial_RxFlag = 0;
		return 1;
	}
	return 0;
}